home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat1 / partmgr.z / partmgr
Encoding:
Text File  |  2002-10-03  |  11.3 KB  |  265 lines
  1.  
  2.  
  3.  
  4. ppppaaaarrrrttttmmmmggggrrrr((((1111MMMM))))                                                        ppppaaaarrrrttttmmmmggggrrrr((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      partmgr - Partition Configuration Tool for Origin
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ppppaaaarrrrttttmmmmggggrrrr [----hhhh]
  13.      ppppaaaarrrrttttmmmmggggrrrr [----llll]
  14.      ppppaaaarrrrttttmmmmggggrrrr [----aaaa]
  15.      ppppaaaarrrrttttmmmmggggrrrr [----nnnn]
  16.      ppppaaaarrrrttttmmmmggggrrrr [----vvvv]
  17.      ppppaaaarrrrttttmmmmggggrrrr ----cccc [----mmmm _m_o_d_e_n_a_m_e]
  18.      ppppaaaarrrrttttmmmmggggrrrr ----xxxx _m_o_d_e_n_a_m_e [----FFFF]
  19.      ppppaaaarrrrttttmmmmggggrrrr ----ssss _m_o_d_e_n_a_m_e [----FFFF]
  20.      ppppaaaarrrrttttmmmmggggrrrr ----iiii [----FFFF]
  21.      ppppaaaarrrrttttmmmmggggrrrr ----dddd [----FFFF] ----ffff _f_i_l_e
  22.      ppppaaaarrrrttttmmmmggggrrrr ----dddd [----FFFF] ----mmmm _m_o_d_e_n_a_m_e ----uuuu [----eeee _v_a_r=_v_a_l_u_e]...
  23.      ppppaaaarrrrttttmmmmggggrrrr ----dddd [----FFFF] ----mmmm _m_o_d_e_n_a_m_e [----pppp _p_a_r_t ----bbbb _b_r_i_c_k_s [----eeee _v_a_r=_v_a_l_u_e]...]...
  24.      ppppaaaarrrrttttmmmmggggrrrr ----dddd [----FFFF] ----mmmm _m_o_d_e_n_a_m_e [----pppp _p_a_r_t ----rrrr _r_a_c_k_s [----eeee _v_a_r=_v_a_l_u_e]...]...
  25.  
  26. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.      ppppaaaarrrrttttmmmmggggrrrr is the partitioning administration tool for the Origin 3000
  28.      series of servers. It provides the System Administrator with capabilities
  29.      to define and store partition definitions, including partition id
  30.      information for bricks and racks, and associated prom environment
  31.      variables.
  32.  
  33.      You must have superuser privilege to use this command. If the system is
  34.      configured as CAP_NO_SUPERUSER, you must have effective capabilities of
  35.      CAP_SHUTDOWN, CAP_DEVICE_MGT and CAP_SYSINFO_MGT.
  36.  
  37.      All the affected partitions have to be rebooted in order to change the
  38.      system to the new partition scheme.
  39.  
  40.      A multi brick Origin 3000 system can be divided into multiple independent
  41.      units for the purposes of booting different kernels on them. These
  42.      systems can be power cycled independently even though they are connected
  43.      by the NUMAlink interconnect. The kernels can detect the presence of
  44.      other partitions by using low level hardware support. A partition is
  45.      identified by its partition id, ppppaaaarrrrtttt, a brick is identified by its brick
  46.      id, bbbbrrrriiiicccckkkk, and a rack is identified by its rack id, rrrraaaacccckkkk.  For more
  47.      information on valid partitioning configurations, see the _S_G_I _O_r_i_g_i_n _3_0_0_0
  48.      _P_a_r_t_i_t_i_o_n_i_n_g _D_o_c_u_m_e_n_t.
  49.  
  50.      The partmgr command line options are:
  51.  
  52.      ----hhhh           Help.  Print a usage message.
  53.  
  54.      ----llll           List brick ids of all known system bricks to standard out.
  55.  
  56.      ----aaaa           List all currently defined modes.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ppppaaaarrrrttttmmmmggggrrrr((((1111MMMM))))                                                        ppppaaaarrrrttttmmmmggggrrrr((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      ----nnnn           Display the current partition id.
  75.  
  76.      ----vvvv           Display the environment variables for the current partition.
  77.  
  78.      ----cccc           Display mode configuration.  If no mode is specified (----mmmm
  79.                   _m_o_d_e_n_a_m_e), the current mode is displayed.
  80.  
  81.      ----xxxx _m_o_d_e_n_a_m_e  Delete a mode.
  82.  
  83.      ----ssss _m_o_d_e_n_a_m_e  Set a mode to be the current mode.  This may require some
  84.                   partitions to be rebooted.
  85.  
  86.      ----iiii           Same as "-s Unpartitioned".  Initializes the system to the
  87.                   default unpartitioned state.
  88.  
  89.      ----dddd           Define a new mode.
  90.  
  91.      ----mmmm _m_o_d_e_n_a_m_e  Specifies a mode name.  This option is used with the ----cccc and
  92.                   ----dddd options.
  93.  
  94.      ----uuuu           When defining a new mode, used to specify an unpartitioned
  95.                   system.
  96.  
  97.      ----pppp _p_a_r_t      Specifies a partition id.  A partition id is a number
  98.                   between 1 and 63, inclusive.  The order of the ----pppp, ----bbbb, ----rrrr
  99.                   and ----eeee options is significant (see the EXAMPLES section
  100.                   below).
  101.  
  102.      ----bbbb _b_r_i_c_k_s    Specifies brick ids (example: 001c13).
  103.  
  104.      ----rrrr _r_a_c_k_s     Specifies rack ids (example: 001).
  105.  
  106.      ----eeee _v_a_r=_v_a_l_u_e Specifies an environment variable name/value pair.
  107.  
  108.      ----ffff _f_i_l_e      When defining a new mode, used to specify an input file.
  109.  
  110.      ----FFFF           Forces override of some sanity checks.  This option should
  111.                   be used with caution.  The user of partmgr should understand
  112.                   the consequences of using this option.
  113.  
  114. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  115.      To define a mode for an 8 brick system with 2 partitions of 4 bricks
  116.      each:
  117.  
  118.      ppppaaaarrrrttttmmmmggggrrrr ----dddd ----mmmm _m_o_d_e_n_a_m_e ----pppp 1111 ----bbbb 000000001111cccc11110000,,,,000000001111cccc11113333,,,,000000001111cccc11116666,,,,000000001111cccc22221111 \
  119.             ----pppp 2222 ----bbbb 000000001111cccc22224444,,,,000000001111cccc22229999,,,,000000001111cccc33332222,,,,000000001111cccc33335555
  120.  
  121.      To define a mode for an unpartitioned system with the prom environment
  122.      variable AAAAuuuuttttooooBBBBooooooootttt set to NNNNoooo:
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ppppaaaarrrrttttmmmmggggrrrr((((1111MMMM))))                                                        ppppaaaarrrrttttmmmmggggrrrr((((1111MMMM))))
  137.  
  138.  
  139.  
  140.      ppppaaaarrrrttttmmmmggggrrrr ----dddd ----mmmm _m_o_d_e_n_a_m_e ----uuuu ----eeee AAAAuuuuttttooooBBBBooooooootttt====NNNNoooo
  141.  
  142.      Here are some examples of input files (----ffff option).  The leading spaces
  143.      are allowed, but not required; they are only added for readability.
  144.  
  145.      EXAMPLE 1:
  146.  
  147.        MODE modename1
  148.  
  149.          PARTITION 1
  150.            BRICKS
  151.              001c10 001c13 001c16 001c21
  152.  
  153.            ENVIRON
  154.              AutoBoot=No
  155.  
  156.          PARTITION 2
  157.            BRICKS
  158.              002c10 002c13 002c16 002c21
  159.  
  160.            ENVIRON
  161.              AutoBoot=No
  162.              OSLoadPartition=scsi(0)disk(1)rdisk(0)partition(0)
  163.              SystemPartition=scsi(0)disk(1)rdisk(0)partition(8)
  164.  
  165.      EXAMPLE 2:
  166.  
  167.        MODE modename2
  168.  
  169.          PARTITION 1
  170.            RACKS
  171.              001 002
  172.  
  173.          PARTITION 2
  174.            RACKS
  175.              003 004
  176.  
  177.      EXAMPLE 3:
  178.  
  179.        MODE modename3
  180.  
  181.          UNPARTITIONED
  182.  
  183.            ENVIRON
  184.              AutoBoot=No
  185.              OSLoadPartition=scsi(0)disk(1)rdisk(0)partition(0)
  186.              SystemPartition=scsi(0)disk(1)rdisk(0)partition(8)
  187.              netaddr=128.162.192.65
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ppppaaaarrrrttttmmmmggggrrrr((((1111MMMM))))                                                        ppppaaaarrrrttttmmmmggggrrrr((((1111MMMM))))
  203.  
  204.  
  205.  
  206. NOTES
  207.      For the ppppaaaarrrrttttmmmmggggrrrr command to function, all of the following requirements
  208.      must be met:
  209.  
  210.      1.  The eeeeooooeeee....sssswwww....ppppaaaarrrrttttiiiittttiiiioooonnnn software package must be installed.
  211.  
  212.      2.  The L1 and L2 firmware must be current.
  213.  
  214.      3.  Partitioning administration must be enabled in all L1s (using the
  215.      ppppaaaarrrrttttddddbbbb eeeennnnaaaabbbblllleeee L1 command).
  216.  
  217.      4.  The mmmmkkkkppppdddd daemon must be running on all partitions for ppppaaaarrrrttttmmmmggggrrrr to
  218.      work. If this is not the case, the ppppaaaarrrrttttmmmmggggrrrr command may not be able to
  219.      shutdown remote partitions.
  220.  
  221.      5.  For the prom to use the environment variables defined in the mode
  222.      definition, the prom environment variable AAAAuuuuttttooooPPPPRRRROOOOMMMMVVVVaaaarrrrssss must be set to 1111.
  223.  
  224.      The term bbbbrrrriiiicccckkkk in this document refers to a CCCC----bbbbrrrriiiicccckkkk.
  225.  
  226.      The ppppaaaarrrrttttiiiittttiiiioooonnnn iiiidddd of 0000 has a special meaning in the OS and cannot be used
  227.      on a partitioned system.  Valid ppppaaaarrrrttttiiiittttiiiioooonnnn iiiiddddssss can be any number between 1111
  228.      and 66663333, both included.
  229.  
  230. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  231.      The ppppaaaarrrrttttmmmmggggrrrr command does not respond to the interrupt key.  This is
  232.      because the partitioning information may be in an inconsistent state
  233.      which may cause problems on a reboot.
  234.  
  235.      The ppppaaaarrrrttttmmmmggggrrrr command performs certain sanity checks on the partition
  236.      config required by the user. It uses the partitioning information
  237.      currently available to do this. Under certain conditions, these checks
  238.      cannot proceed without input from the user.
  239.  
  240.      Partition ids must be unique and a brick can be included in 1 partition
  241.      only.
  242.  
  243. WWWWAAAARRRRNNNNIIIINNNNGGGGSSSS
  244.      The ppppaaaarrrrttttmmmmggggrrrr command is not intended for casual use.  If used incorrectly,
  245.      it can completely freeze all partitions in the system and prevent it from
  246.      even booting the PROM.  It is strongly recommended that this command be
  247.      used with the co-ordination of the System Administrators of all the
  248.      current partitions.
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.